home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / textual / keychang / !KeyChange / !Help next >
Text File  |  1992-08-07  |  6KB  |  135 lines
  1.  
  2.  
  3.                       Help for the KeyChange module
  4.                       =============================
  5.  
  6. KeyChange provides two facilities related to the keyboard; it makes the
  7. numeric keypad keys act like the function keys, and it lets you get extra
  8. codes from the keyboard for use with so-called "hot-key" utilities.
  9.  
  10.   The former is useful because (at least for right-handed people) the keypad
  11. is likely to be easier to use than the function keys, and the need to use
  12. the keypad for entering numbers is likely to be fairly limited. You can
  13. also switch back to the normal mode if necessary.
  14.  
  15.   The second function allows background utilities to respond to keypresses
  16. without having them intercepted by a foreground application. You can,
  17. however, only use it with utilities which allow you to choose freely which
  18. keypresses you want to use, as the KeyChange module generates codes which
  19. are not normally available.
  20.  
  21.   A detailed description of the functions offered by the module can be found
  22. in the Manual file which should accompany this one. This file describes how
  23. to load and control the module, and details the files you should have.
  24.  
  25.   Please note that this code is not guaranteed to work with other than the
  26. standard UK keyboard, as supplied with A300 and A400 machines. In particular,
  27. it will obviously not work on an A4!
  28.  
  29. Installing KeyChange.
  30. ---------------------
  31.  
  32. The simplest way of installing KeyChange is to double-click on its icon.
  33. This will immediately enable you to use the numeric keypad keys as function
  34. keys, with the following mapping:
  35.  
  36.  
  37.                       +------+------+------+------+
  38.                       |      |      |      |      |
  39.                       | N.L. |  F10 |  F11 |  F12 |
  40.                       |      |      |      |      |
  41.                       +------+------+------+------+
  42.                       |      |      |      |      |
  43.                       |  F7  |  F8  |  F9  | Inst |
  44.                       |      |      |      |      |
  45.                       +------+------+------+------+
  46.                       |      |      |      |      |
  47.                       |  F4  |  F5  |  F6  |  F14 |
  48.                       |      |      |      |      |
  49.                       +------+------+------+------+
  50.                       |      |      |      |      |
  51.                       |  F1  |  F2  |  F3  |  E   |
  52.                       |      |      |      |  n   |
  53.                       +------+------+------+  t   |
  54.                       |             |      |  e   |
  55.                       |    Print    |  F15 |  r   |
  56.                       |             |      |      |
  57.                       +-------------+------+------+
  58.  
  59.  
  60.   These keys should be treated identically to the normal function keys by
  61. most programs (even outside the desktop), although it is possible that some
  62. programs may read the state of the keyboard directly, which will prevent
  63. this from working. Note that the keys F14 and F15 have no equivalent on a
  64. standard keyboard. "Inst" means the Insert key. Enter is treated normally.
  65. Pressing Num Lock returns the keypad to its usual operation, with a beep for
  66. confirmation, and pressing it again returns to the function-key mode.
  67.  
  68.   If you type "*RMKill InternationalKeyboard" at the command line you will
  69. be able to use the "extended function keys" by pressing one of the Alt keys
  70. with a function key (either a normal one or one on the keypad). You will
  71. not, however, be able to use the Alt keys to type "special" characters
  72. (accented characters etc.). If you want to do this permanently, type
  73. "*Unplug InternationalKeyboard" instead; to recover the previous setup type
  74. "*RMReInit InternationalKeyboard".
  75.  
  76.   Alternatively, type "*KeyChange C" at the command line (see below),
  77. and you can then use the right-hand Ctrl key instead of Alt; the key will
  78. retain its normal function except with keys F1 to F9 and Print, and all of
  79. the keypad keys in function key mode.
  80.  
  81.   It is also possible to use the keypad to get these extra codes; see the
  82. Manual file for details.
  83.  
  84.   Use of these options requires a hot-key utility which understands the
  85. extra codes; see the Manual file for details. Alternatively, if KeyChange
  86. has been supplied with such a utility, see the documentation provided with
  87. it.
  88.  
  89. The KeyChange Command.
  90. ----------------------
  91.  
  92. The module provides a single command, *KeyChange, which controls which of
  93. the three operating modes are enabled. (To enter a command, press F12). The
  94. modes are:
  95.  
  96. Keypad (P) - makes the numeric keypad keys act as function keys.
  97. Extended codes (E) - allows extra hot-key codes to be generated.
  98. Right-Ctrl (C) - Allows the right-hand Ctrl key to generate the extra codes.
  99.  
  100. The modes can be enabled by following the *KeyChange command with one of the
  101. letters P, E or C, and disabled using ~P, ~E and ~C. Examples:
  102.   
  103. *KeyChange P
  104. *KeyChange PC~E
  105. *KeyChange C ~P
  106.  
  107. As you can see, the order of the parameters doesn't matter, and you can
  108. separate them with spaces if you like (but you can't have a space after ~).
  109. The *KeyChange command with no arguments prints the current status.
  110.  
  111.   The default status when the module is loaded is ~P E ~C. However, you can
  112. change this if you load the module from a !Boot file (or any Obey file),
  113. for example:
  114.  
  115. *RMLoad <path>.KeyChange E C ~P
  116.  
  117. where <path> should be replaced by the full name of the directory in which
  118. the KeyChange module resides (shown in the title bar of the Filer window).
  119.  
  120.   Finally, the *KeyChange command can also be followed by a number from 1
  121. to 4, which selects the keypad mode. See the Manual file for details.
  122.  
  123. File list.
  124. ----------
  125.  
  126.   The full set of files is as follows:
  127.  
  128. !Help     - this file.
  129. Manual    - a full description of the functions provided by KeyChange.
  130. License   - the conditions under which the software may be distributed.
  131. KeyChange - the module itself.
  132. KeySrc    - the module source code.
  133. KeyCodes  - a technical description of how the keyboard drivers function.
  134. ProgInfo  - an explanation of how the program works.
  135.